主题
快捷键模块总览 - Overview
本分类做什么
监听 用户输入并回调：键盘组合键、鼠标按钮、滚轮、移动、拖动。需 启动 Hook 后 注册 各热键；与 键盘 的 主动按键、WaitKey 的 同步阻塞 均不同。
一、生命周期
| 接口 | 差异 |
|---|---|
| StartHotkeyHook | 启动 全局/插件上下文监听（作用域见详情页）。 |
| StopHotkeyHook | 停止 并释放 Hook。 |
必须先 Start 再 Register；否则注册失败或无效。
二、按设备类型分组
| 类型 | 注册 | 卸载 |
|---|---|---|
| 键盘 | RegisterHotkey | UnregisterHotkey |
| 鼠标点击 | RegisterMouseButton | UnregisterMouseButton |
| 滚轮 | RegisterMouseWheel | UnregisterMouseWheel |
| 移动 | RegisterMouseMove | UnregisterMouseMove |
| 拖动 | RegisterMouseDrag | UnregisterMouseDrag |
差异：点击 与 移动 分离，避免高频移动拖垮 CPU；拖动 需按下/移动/抬起组合逻辑（见详情页）。
三、与其它模块对比
| 对比项 | 快捷键（本分类） | 键盘 WaitKey | 键盘 KeyPress |
|---|---|---|---|
| 方向 | 监听 用户 | 等待 用户 | 模拟 用户 |
| 阻塞 | 异步回调 | 同步阻塞 | 不阻塞 |
| 典型用途 | 全局热键、宏触发 | 脚本暂停 | 自动化输入 |
四、与 LockInput
LockInput 会 屏蔽前台输入；与 Hook 同时 时，行为以 系统消息顺序 与插件实现为准，调试时 建议先停 Hook 再锁输入。
五、快速选型
| 需求 | 建议 |
|---|---|
| F9 暂停脚本 | RegisterHotkey + 回调设标志位 |
| 侧键定义宏 | RegisterMouseButton |
| 仅当前脚本内等键 | WaitKey 更简单 |
六、注意
- 部分 游戏全屏 会吞掉低级 Hook，需 权限 或 驱动模式（见更新说明）。
- 卸载 所有注册后再
StopHotkeyHook，避免泄漏。